The PrintOMatic Xtra uses a "frames" metaphor for creating areas on the page where text or graphics can be flowed. The basic procedure is to create one or more "linked" frames on a page of a document, then append items to the newly created frames. The following commands are used to create frames and append their contents.
newFrame creates a new frame on the current page
append appends contents to the current frame
appendFile appends the contents of a text or graphic file to the current frame
getInsertionPoint gets the location of the insertion point within the current frame
pageBreak inserts a page break in the text flow
newFrame
Syntax: newFrame document, rect, linkedToPrevious
The newFrame command adds a new "frame" to the current page of the document, and makes it the "current" frame. Text and graphic items can be flowed into the current frame using the append and appendFile commands.
The linkedToPrevious parameter determines whether the contents of the previous frame will flow into the new frame once the previous frame is filled. When you create a new frame that is not linkedToPrevious, you can no longer append items to the previously "current" frame. Also note that you cannot link frames between the master page and a body page.append
Syntax: append document, member whichCastmember [, ... , autoAppend ]
append document, member whichCastmember of castLib whichLib [, ... , autoAppend ]
The append command appends one or more items to the current "frame" of a document object. If no current frame exists in your document, the PrintOMatic Xtra will attempt to create a "default" frame for you, which is the width and height of the page, minus the current margins.
The autoAppend parameter, which is always the last parameter in a call to append, controls whether or not new pages will be created "on the fly" if the PrintOMatic Xtra runs out of space on the last "frame" in your document. If this parameter is set to TRUE, new pages will be created with the same "frame" layout as the last page of your document. PrintOMatic will create as many new pages as are necessary to flow all the specified elements into your document . If this parameter is not specified when you call append, its value defaults to TRUE.
AutoAppending is not allowed when flowing items into a frame on the master page of a document.